home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr36 / znews097.zip / ZIPNEWS.DOC < prev    next >
Text File  |  1993-05-08  |  32KB  |  622 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                             ZipNews v0.97 (5/08/93)
  8.  
  9.                  (c) Copyright 1993 by J.C. Kilday Associates
  10.  
  11.  
  12.                      Developed at the Northern Lights BBS
  13.  
  14.                         207-761-4782   v.32bis/VHST
  15.  
  16.  
  17.  
  18.  
  19.                                Table of Contents
  20.                                -----------------
  21.  
  22.                        Introduction ..................... 1
  23.  
  24.                        Description ...................... 2
  25.  
  26.                        Installation Overview ............ 3
  27.  
  28.                        Installation Details ............. 4
  29.  
  30.                        Operating/Using ZipNews .......... 9
  31.  
  32.                        Distribution and Restrictions .... 9
  33.  
  34.                        After You Register ZipNews ...... 10
  35.  
  36.                        Support ......................... 10
  37.  
  38.  
  39.                                  ZipNews v0.97                       Page 1
  40.      Introduction
  41.      ------------
  42.  
  43.      ZipNews is a door for use on PCBoard, Wildcat!, and Waffle BBSs.  When
  44.      operating on a Waffle system  it is run as Waffle  "external command".
  45.      It's purpose  is fast  delivery of  Usenet news  articles for  offline
  46.      reading.  It greatly simplifies the process of reading Usenet news  by
  47.      allowing the caller  to download new  postings in compressed  form for
  48.      reading  offline.    Callers  may  download  their news in plain ASCII
  49.      format, compressed using an archiver of their choice.  But the primary
  50.      function of this door is to provide news "packets" for offline reading
  51.      through use of the ZipNews Reader.  The ZipNews Reader is a  companion
  52.      program to the door and usually  may be obtained from the same  source
  53.      as this door.
  54.  
  55.      The  ZipNews  door  allows  a  broad  selection of DOS-based archiving
  56.      utilities for compressing the news packet and it supports a variety of
  57.      file transfer protocols (use of Forsberg's DSZ file transfer  protocol
  58.      module  is  recommended).    The  selection of archiving utilities and
  59.      protocols  is  determined  by  the  system  operator.   The individual
  60.      command  line  specifications  are  also  established  by  the  system
  61.      operator using a configuration text file.  A sample configuration file
  62.      is included in this package.
  63.  
  64.      First-time users entering the  ZipNews Door are prompted  to establish
  65.      their personal choices of archive utility and file transfer  protocol.
  66.      User choices are maintained  by the system and  may be changed by  the
  67.      user during subsequent calls.  First-time users of the door on PCBoard
  68.      and Wildcat! systems are  prompted to choose an  Internet ID of up  to
  69.      8-characters in length.  The door does not allow a caller to choose an
  70.      Internet ID  that is  already in  use by  another caller  to the  same
  71.      system.  On Waffle-only systems,  users are registered per the  normal
  72.      Waffle conventions.
  73.  
  74.      During their  first use  of the  ZipNews door  on PCBoard and Wildcat!
  75.      systems, users are  prompted to download  a list of  newsgroups within
  76.      their first  packet.   If the  caller is  using the  DOS-based ZipNews
  77.      Reader,  newsgroup  selections  and  settings  of  last  article  read
  78.      pointers are established offline, and the results are uploaded back to
  79.      the door.  Callers to Waffle-only systems may also use this  procedure
  80.      (first-time  callers  are  not  automatically  prompted  to  do  this,
  81.      however).
  82.  
  83.      If the caller is NOT using the ZipNews Reader, when accessing the door
  84.      on other-than-Waffle  systems (such  as PCBoard  or Wildcat! systems),
  85.      there is presently no provision  for selecting newsgroups.  Perhaps  a
  86.      friendly sysop could help such  callers by modifying their JOIN  files
  87.      via a standard  text editor.   The reader is  required, when accessing
  88.      such systems, for selecting newsgroups (unless the sysop is willing to
  89.      lend a hand).  On Waffle  BBS systems or on systems where  Waffle runs
  90.      as  a  door,  however,  callers  without  ZipNews readers, may use the
  91.      normal Waffle commands to join the desired groups.
  92.  
  93.  
  94.                                  ZipNews v0.97                       Page 2
  95.  
  96.      When download of a news packet is requested, the user is presented  an
  97.      active display indicating the newsgroups being scanned, the number  of
  98.      articles  being  extracted,  and  other  progress information.  At the
  99.      conclusion of the scan, the user  has the option of NOT accepting  the
  100.      packet and returning to the Waffle system to alter groups JOINed, etc.
  101.      Once the  user affirms  that an  assembled packet  should be sent, the
  102.      packet  is  compressed  and  the  transfer  of  the  resulting file is
  103.      initiated.  If the normal  process is interrupted before a  successful
  104.      conclusion, the "last article read"  pointers in the user's JOIN  file
  105.      are restored to their previous settings.  Otherwise, upon a successful
  106.      download,  these  pointers  are  appropriately  updated.  (Note:  this
  107.      operation  is  dependent  upon  the  archiver  and  protocol   modules
  108.      returning appropriate "success/fail" DOS ERRORLEVELs.  Utilities  such
  109.      as PKZIP and DSZ are known to work correctly in this regard.)
  110.  
  111.      ZipNews is SHARE-compatible and can support multi-node operations from
  112.      a single configuration file (ZN.CFG).  It can handle non-standard comm
  113.      port specifications and speeds  to 57,600 bps.   FOSSIL communications
  114.      are not used.   ZipNews disables FOSSIL supported  comm when run.   On
  115.      Waffle systems,  FOSSIL support  is "reset"  per the  normal way  when
  116.      returning  to  Waffle.     On  other   systems,  ZipNews  leaves   the
  117.      communications set up  such that the  FOSSIL can resume  upon when the
  118.      door exits back to the main board.
  119.  
  120.      ZipNews  is  being  distributed  as  a  fully  functional package (not
  121.      crippled in any way).  In its unregistered form, ZipNews DOES  display
  122.      on-screen,  and  in  the  files  produced,  notices  informing  system
  123.      operators and users that it is an unregistered, evaluation copy.   The
  124.      executable  is  self-registering  in  that  when  a valid registration
  125.      number  is  input  these  notices  are  removed  and,  thereafter, the
  126.      registrant's name is displayed.
  127.  
  128.      The complete ZipNews v0.97 package includes the following files:
  129.                 ZIPNEWS.DOC  - this file
  130.                 ZN.EXE       - executable module
  131.                 ZN.CFG       - sample ZipNews configuration file
  132.                 ZIPNEWS      - the Waffle external command file for ZipNews
  133.                 ZNORDER.FRM  - order form for registering ZipNews
  134.                 READ.ME      - quick review and features summary
  135.                 WHATS.NEW    - major enhancements and bug fixes in this
  136.                                release.
  137.                 ZIPNEWS.PCB  - sample ZipNews door batch file for use on
  138.                                PCBoard (and Wildcat!) BBS systems
  139.                 NLBBS.GPS    - Sample newsgroups file
  140.  
  141.      Description
  142.      -----------
  143.      ZipNews is  designed for  operation on  MS-DOS 3.O  and later systems.
  144.      Operation with earlier DOS versions is not supported.
  145.  
  146.      ZipNews is being released for  widespread use while in its  final BETA
  147.      test stages.  Operation of the door is very sound, but there are  some
  148.      original requirements  of the  package that  are not  yet implemented.
  149.      Until such requirements  have been completed,  it is planned  that the
  150.      ZipNews door will remain a product in BETA testing.
  151.  
  152.      Zipnews has been tested  primarily in a DOS  5.0/DESQview environment,
  153.      on a system  running 4 nodes  (PCBoard as the  primary BBS and  Waffle
  154.      1.65  as  a  Door).    It  has  not been tested with other versions of
  155.      Waffle.
  156.  
  157.                                  ZipNews v0.97                       Page 3
  158.  
  159.      Installation Overview
  160.      ---------------------
  161.  
  162.      This section attempts to suumarize the major steps in setting up.  The
  163.      next section covers installation in greater detail.
  164.  
  165.      ZipNews requires the installation of  at least portions of the  Waffle
  166.      BBS package if you are not running the full Waffle BBS.  The  required
  167.      parts of  Waffle are  basically the  files necessary  to implement the
  168.      uucp transport mechanism and to establish the structure and control of
  169.      newsgroups and mailboxes.  This document is not intended to serve as a
  170.      substitute for Waffle documentation or as a guide in its installation.
  171.      Suffice  it  to  say,  that  the  Waffle  docs and configuration files
  172.      pertaining  to  the  following  executables  are  needed for the basic
  173.      (non-Waffle BBS) setup:
  174.  
  175.             UUCICO.EXE
  176.             COMPRESS.EXE
  177.             UUX.EXE
  178.             UUXQT.EXE
  179.             BATCH.EXE
  180.             RMAIL.EXE
  181.             RNEWS.EXE
  182.  
  183.      The first two files listed above are actually public domain  programs,
  184.      but the  remainder and  the needed  docs are  copyrighted by  Darkside
  185.      International, and require a registration fee of $30 payable to Thomas
  186.      E. Dell.  The  complete Waffle package can  be obtained at most  large
  187.      BBSs or via anonymous FTP from major Internet archive sites under  the
  188.      name WAF165.ZIP (the name as of this writing).
  189.  
  190.      Once Waffle (or Waffle uucp operation) is installed:
  191.  
  192.      1. Place ZN.EXE and the sample ZN.CFG into a directory in your PATH
  193.         (\waffle\bin will do quite nicely).
  194.  
  195.      2. Customize ZN.CFG as needed using an ASCII text editor.  This also
  196.         involves naming and specifying command lines for archive utilities
  197.         and file tranfer protocols you wish to make available to callers.
  198.  
  199.      3. a. For ZipNews as a Waffle external command:
  200.  
  201.            Make (or modify) the ZIPNEWS external command file and place
  202.            it in your \waffle\external directory.  See the sample external
  203.            command file included in this package -- filename is ZIPNEWS.
  204.  
  205.         b. For ZipNews as a door under PCBoard or Wildcat!:
  206.  
  207.            Using the file ZIPNEWS.PCB as a guide, set up the necessary
  208.            door batch file for your system (possibly multiple files if
  209.            running multi-node).
  210.  
  211.      4. Provide for setting the required DOS ENVIRONMENT variables.  A very
  212.         important one is the DSZPORT variable.
  213.  
  214.      5. If running a multi-node system, provide for uniquely named work
  215.         directories (one for each node) for temporary file storage.  This
  216.         will require an environment variable also.
  217.  
  218.                                  ZipNews v0.97                       Page 4
  219.  
  220.      6. If running a multi-node system, set the read-only (write protect)
  221.         file attribute bit on ZN.EXE (avoids SHARE violations while
  222.         program loading during normal multi-node operations).
  223.  
  224.  
  225.      Installation Details
  226.      --------------------
  227.      ZipNews (ZN.EXE) should be placed in a directory contained in your DOS
  228.      PATH (e.g., \waffle\bin).    Your ZipNews  configuration file (ZN.CFG)
  229.      should be placed in the same directory.  WARNING:  ZN.EXE locates  the
  230.      directory in which it resides, no matter how started, and you  MUST(!)
  231.      have ZN.CFG located in that same directory for proper operation.
  232.  
  233.      If you are running ZipNews as a Waffle external command, the  external
  234.      command file should be quite similar to that provided as part of  this
  235.      package.  It should be  placed in your \waffle\external directory  (on
  236.      Waffle  v1.65  systems).    An  example  of this one-line file appears
  237.      below:
  238.  
  239.           zipnews /local /reset /command="d:\waffle\bin\zn %A"
  240.  
  241.      Note that the only command line parm required on startup is the Waffle
  242.      account (caller's ID).
  243.  
  244.      If you are running ZipNews as  a door under PCBoard or Wildcat!:   the
  245.      sample door batch  file contained in  ZIPNEWS.PCB should be  used as a
  246.      guide in setting up the  necessary door batch file(s) on  your system.
  247.      The sample file shows how a multi-node system might be set up using  a
  248.      single  door  batch  file  (through  use of PCBoard's door environment
  249.      variables).
  250.  
  251.      Also it should be noted that  two methods of providing user access  to
  252.      ZipNews on PCBoard systems are  documented in ZIPNEWS.PCB.  The  first
  253.      is now  the preferred  method and  the one  that MUST  be employed  if
  254.      setting up for use with Wildcat! systems.  We'll get into the  details
  255.      of the two methods shortly.
  256.  
  257.      Here's the syntax for invoking the ZipNews door:
  258.  
  259.          zn @UserListName | Username [local] [pcb | wc]
  260.  
  261.        Where:
  262.  
  263.          zn is the executable name
  264.  
  265.          @UserListName indicates a list is specified, and UserListName
  266.          is the full pathname to the list of ZipNews door users (created
  267.          and maintained by the door).  This option, rather than the
  268.          alternative specification of UserName is the recommended method
  269.          for invoking the door from PCBoard or Wildcat!.
  270.  
  271.          UserName is the Internet ID, or the Waffle "username" of the
  272.          caller (for whom a directory of that name is maintained on the
  273.          system containing personal configuration data).  This option is
  274.          the required method for invoking from Waffle as an external
  275.          command.
  276.  
  277.          (You must specify either the user list path prefixed by the @
  278.          symbol OR the username when invoking the door.)
  279.  
  280.                                  ZipNews v0.97                       Page 5
  281.  
  282.          "local" may be specifed for sysop testing of the setup without
  283.          having to go online to test.   (Note: new user registration
  284.          processes are not functioning well in local mode in v0.97 BETA;
  285.          but all other online door operations are pretty well emulated in
  286.          the local mode.)
  287.  
  288.          "pcb" or "wc" must be specified as the 2nd or 3rd parm (depending
  289.          on whether the "local" parm was given) if the door is NOT being run
  290.          as an external command under Waffle.  (pcb for PCBoard; wc for
  291.          Wildcat!).
  292.  
  293.          Examples:
  294.  
  295.             zn @c:\user\zn_users.lst local pcb
  296.  
  297.          Above, the system operator invokes the door locally to simulate
  298.          operation as a PCBoard door, and points it to the list of valid
  299.          users of the door located in c:\user .   (By the way, that list
  300.          of users will be searched for a match against the caller name
  301.          extracted from PCBoard's drop file, PCBOARD.SYS.   If a match is
  302.          found, the caller's Internet-style login ID is extracted from the
  303.          file.  If a match is not found, the caller will be handled as a
  304.          first-time ZipNews user.)
  305.  
  306.             zn @c:\user\zn_users.lst wc
  307.  
  308.          Similar to the first example, but here the door is invoked in
  309.          online mode (comes up as a communications application) and
  310.          looks for the Wildcat! door drop file, USERINFO.DAT.  It will
  311.          extract the caller name from line 1 of this file.
  312.  
  313.             zn johndoe pcb
  314.  
  315.          This is an older form of invoking the door that was the only one
  316.          available for operations with PCBoard before v0.97 BETA.   It is
  317.          still available for any PCBoard operators that might prefer it,
  318.          OR be unwilling to change their current setup.  The method
  319.          requires the caller to invoke the door by following the PCBoard
  320.          door command with his/her Internet-style login ID, thusly:
  321.  
  322.                 zipnews johndoe    OR   door 1 johndoe
  323.  
  324.          More will be said about this method next, but it is no longer the
  325.          recommended method for invoking ZipNews.
  326.  
  327.      With basic understanding of the  door's command syntax out of  the way
  328.      let's return to the door batch file (the sample being ZIPNEWS.PCB) and
  329.      discuss how the door is accessed.  The line invoking the door uses the
  330.      preferred method  of accessing  the door  from PCBoard  (and the  only
  331.      method for Wildcat!) in  that the first parm  points a file that  is a
  332.      list of users.  This file in d:\users\zn_users.lst per the example  is
  333.      completely maintained by the  door.  If no  such list exists when  the
  334.      door is first installed, it is created when the door handles its first
  335.      caller.  When a caller uses  the ZipNews door for the first  time, the
  336.      door adds the caller's BBS name and requested Internet-style login  ID
  337.      to the list.
  338.  
  339.                                  ZipNews v0.97                       Page 6
  340.  
  341.      The ZipNews users list is in standard ASCII text format.  A few  lines
  342.      of the list list might look like this:
  343.  
  344.      JOHN DOE jdoe
  345.      MARY DOE maryd
  346.      SYSOP jkilday
  347.  
  348.      The words in all caps on each line are the full caller name  extracted
  349.      from the door drop file (PCBOARD.SYS, USERINFO.DAT, etc.).   Separated
  350.      by a space from  the full caller name,  and in all lower  case, is the
  351.      Internet-style ID which the caller chose during his/her first  session
  352.      with the door.
  353.  
  354.      IMPORTANT NOTE:
  355.  
  356.          If you are upgrading from a prior release of the ZipNews door
  357.          used as a door under PCBoard, OR if you are adding ZipNews as
  358.          a PCBoard  or Wildcat  door in  a system  that also  has been
  359.          running Waffle as a door, there is an important task you must
  360.          perform in order to allow former users of the door (or  users
  361.          of the Waffle system) access  to this version of the  ZipNews
  362.          door.   You must  add your  current Waffle  door users to the
  363.          ZipNews users list manually with a text editor!
  364.  
  365.          Reason:    Beneath  the  "user"  directory  specified in your
  366.          ZN.CFG file (and the same  directory used by the Waffle  BBS,
  367.          if used on your  system) individual callers' directories  are
  368.          created  to  contain  personal  setup and status information.
  369.          When ZipNews identifies  a new, first-time  user of the  door
  370.          (caller name not  on the ZipNews  users list), the  door asks
  371.          the "new user" to specify their desired login ID.  THE CALLER
  372.          IS NOT  PERMITTED TO  USE ANY  ID THAT  CORRESPONDS TO A USER
  373.          DIRECTORY ALREADY IN EXISTENCE.
  374.  
  375.          Therefore, any users of a Waffle system already installed  on
  376.          your  system  (or  of  a  ZipNews  door  formerly  used under
  377.          PCBoard)  must  be  added  manually  to the new ZipNews users
  378.          list.   Otherwise, they  will NOT  be granted  access to this
  379.          implementation of the door with their current or former ID.
  380.  
  381.      If you are operating ZipNews as  a door under PCBoard, you may  choose
  382.      to set up access by your callers  in a different way.  This method  is
  383.      ONLY available for PCBoard systems,  and was used in earlier  releases
  384.      of ZipNews.   If you examine  the ZIPNEWS.PCB file  (sample door batch
  385.      file provided with this package,  you will see a door  invocation line
  386.      that has been commented out.  It makes use of the PCBoard  environment
  387.      variable named PCBDOOR (and whose  value is denoted in the  batch file
  388.      by %pcbdoor%).  This method requires your caller to invoke the door by
  389.      following the  door command  with his/her  login ID,  thusly:  zipnews
  390.      johndoe ; OR door 1 johnndoe ; OR open 1 johndoe
  391.  
  392.      This form of access is similar to that used for invoking from  Waffle.
  393.      But, if used for PCBoard (with the "pcb" parm on the command line) the
  394.      door does  not unconditionally  allow access  even if  it finds a user
  395.      directory corresponding to the login ID.  It must also find a file  in
  396.      that directory named PCB.ID and that file must contain the caller name
  397.      as  contained  in  the  PCBoard  door  drop file, PCBOARD.SYS.  So, if
  398.      johndoe logs in under this access method,  ZipNews would  verify  that
  399.  
  400.                                  ZipNews v0.97                       Page 7
  401.  
  402.      the PCB.ID  file in  the johndoe  user directory  contains  the single
  403.      line  containing  "JOHN  DOE"  (assuming  this  caller  name  was   in
  404.      PCBOARD.SYS).  This form of addressing scheme works well,  and handles
  405.      first-time user logins  just as effectively  as does the  ZipNews user
  406.      list method (using  the @users.lst approach),  but it does  force your
  407.      callers to always enter their ID  following the door command.  Not  as
  408.      "seamless" perhaps as the newer  method, but just as effective.   This
  409.      method remains  available in  ZipNews to  accommodate those  who might
  410.      have set it up using earlier releases on their PCBoard systems.
  411.  
  412.      To configure ZipNews to your system, use a standard ASCII text  editor
  413.      to modify the ZN.CFG provided.  The basic ZN.CFG format rules are:
  414.  
  415.         1) Lines beginning with a space or a # symbol are ignored.
  416.         2) The 12 configuration subject titles listed below MUST be
  417.            present in the finished .CFG file and each must be followed
  418.            by a colon (:).  There MAY be intervening whitespace.
  419.  
  420.                newsgroups
  421.                user
  422.                temporary
  423.                bbs
  424.                abbrev
  425.                maximum
  426.                archivers
  427.                protocols
  428.                formats
  429.                organization
  430.                hostname
  431.                list
  432.  
  433.         3) The lines may be in any order, but the sub-lines for archivers
  434.            and protocols must be grouped within their respective sections,
  435.            and with the "prompt" lines immediately preceding the
  436.            corresponding command line specifications.
  437.         4) The command lines for the protocols contain one character in
  438.            the first position which is not a part of the command line.
  439.            This is the "selection character", that by which a caller may
  440.            express his/her protocol choice.
  441.  
  442.      Additional conventions used in the ZN.CFG file follow.
  443.  
  444.      If you need to specify more than one top level news directory on  your
  445.      system, indicate the  full pathname to  each (without a  trailing "\")
  446.      and with a space separating each pathname.
  447.  
  448.      If you have  sufficient RAM available  for use of  a RAMDISK, such  is
  449.      heartily recommended -- not only  for speed gains, but for  preventing
  450.      wear and tear on your hard drive.   However, you may name a hard  disk
  451.      and directory  in the  "temporary" parameter  as your  work directory.
  452.      This is the directory in which the extracted news articles are  placed
  453.      and compressed for download.  If you are running a multi-node  system,
  454.      you will need to specify multiple temporary work directories (one  for
  455.      each node) using this parameter . Here's how to do it:
  456.  
  457.                                  ZipNews v0.97                       Page 8
  458.  
  459.         1) Set an ENVIRONMENT variable for each node.  In each node's
  460.            ENVIRONMENT a new variable should be defined, NODE, for example.
  461.            Assign the number of the node to each one as required.  Thus
  462.            in the ENVIRONMENT controlling node 1, you would set NODE=1,
  463.            for node 2, NODE=2 , etc.
  464.            (On PCBoard systems you could use the standard PCBNODE variable,
  465.            and on Wildcat!, WCNODEID, etc.)
  466.         2) Specify your "temporary" parameter such that it contains
  467.            the variable name with a % before and after it (just as in
  468.            DOS batch files).   So you might specify in your ZN.CFG line:
  469.  
  470.            temporary  :    g:\work%node%
  471.  
  472.            This would be interpreted by ZipNews running on node 1 as
  473.            g:\work1, on node 2 as g:\work2, etc.
  474.  
  475.      This method  will allow  you to  run any  number of  BBS nodes  from a
  476.      single copy of ZN.COM and ZN.CFG.
  477.  
  478.      It is recommended  that Forsberg's ubiquitous  DSZ protocol module  be
  479.      used to support file transfers.  In fact, ZipNews has not been  tested
  480.      with any other.  Normally protocol modules must have the comm port and
  481.      speed communicated to them when invoked.  DSZ automatically determines
  482.      the speed, so this  spec is not necessary.   To specify the  comm port
  483.      number, or to  specify a non-standard  comm port, you  set the DSZPORT
  484.      environment variable.  (Set DSZPORT=1, for COM1:, for example.  Or for
  485.      a non-standard port at  hex address 3e8 and  using IRQ 5, it  would be
  486.      necessary to specify DSZPORT=3e8,5.  See DSZ docs for further info  as
  487.      necessary.)
  488.  
  489.      WARNING:  If  you do not  SET DSZPORT=SomeCommPort, ZipNews  will exit
  490.      with an error message.   The DSZPORT setting  is required even if  you
  491.      opt to use a different protocol module.
  492.  
  493.      (A future release of ZipNews may allow specification of port and speed
  494.      via substitutable parameters,  such as %1,  %2, etc.   If DSZ is  used
  495.      with  this  release,  however,  capability  for handling substitutable
  496.      parameters is not necessary.)
  497.  
  498.      Another required environment  variable for the  running of ZipNews  is
  499.      the WAFFLE variable.   But you're all using  that already, right?   :)
  500.      ZipNews requires that the WAFFLE variable be present, but the  present
  501.      release does not actually access your STATIC file.
  502.  
  503.      If you're running a multi-node system, there's one last step necessary
  504.      for reliable operations.  Switch to the directory in which you  placed
  505.      ZN.EXE  and,  using  the  DOS  ATTRIB  command or other file attribute
  506.      setting/resetting utility, set the  READ ONLY attribute bit  ON (write
  507.      protect).  This will  prevent SHARE violations during  program loading
  508.      under normal multi-node operations.
  509.  
  510.      This completes the installation process.
  511.  
  512.  
  513.                                  ZipNews v0.97                       Page 9
  514.      Operating/Using ZipNews
  515.      -----------------------
  516.  
  517.      There is not much more to say re:  operations; ... the first time  you
  518.      fire up ZipNews, it will be pretty obvious how it is used.  You should
  519.      be reminded of the local mode of operation.  You might start it up on
  520.      a Wildcat! system like this:
  521.  
  522.                 zn @d:\waffle\user\zn_user.lst local wc
  523.  
  524.      The above assumes you are PATHed to the directory in which you  loaded
  525.      ZN.EXE and that  there is a  USERINFO.DAT (Wilcat! door  drop file) in
  526.      the current directory.
  527.  
  528.      In local mode you may operate the door pretty much as you would if  it
  529.      were online.   There currently are  two areas of  exeception.  If  you
  530.      request a download, a ZipNews  packet (not compressed) may be  created
  531.      and left in the work directory (specified by "temporary" in the ZN.CFG
  532.      file).  This should prove helpful in testing parts of your setup.  The
  533.      second area is the new user login process, the prompting for new  user
  534.      ID,  etc.    This  functional  area  of  the code not been finished to
  535.      operate well in local mode in this release.
  536.  
  537.      Re:  advising your users in use of the ZipNews door and its output  --
  538.      ZipNews' ASCII text  format can be  viewed quite conveniently  using a
  539.      text viewer such as Vern Buerg's LIST utility.  If, for example, you'd
  540.      like to quickly move from one  message to another, set LIST to  search
  541.      for "Subject:".  LIST nicely highlights the found line.  To search for
  542.      the next occurrence with  LIST, hit the "A"  key.  To quickly  scan to
  543.      reach the next newsgroup, use "* * <" as the search argument, etc.
  544.  
  545.      Some of your callers might be confused as to what first to do with the
  546.      news packet received.  The source of confusion stems from the use of a
  547.      characteristic file extension of "ZNS" for the compressed news packet,
  548.      rather than ZIP or ARC, etc.  Most unarchiving utilities will work  on
  549.      a valid archive when supplied the  full filename and extension.  If  a
  550.      caller  has  a  ZipNews  packet  created  with PKZIP, for example, the
  551.      unarchiving command would be:
  552.  
  553.         PKUNZIP yourbbs.zns  (where "yourbbs" represents the name you have
  554.                                 selected for the "abbrev" parm in ZN.CFG)
  555.  
  556.      Distribution  and  Restrictions
  557.      -------------------------------
  558.  
  559.      ZipNews is made available to you as a fully functional package.  It is
  560.      distributed as SHAREWARE.   Should you  decide to use  ZipNews on your
  561.      system you are obliged  to register the product  for a fee of  $19.95.
  562.      Registered users are provided support via the BBS mentioned at the end
  563.      of this documentation OR via e-mail on the Internet.  You may use  the
  564.      form ZNORDER.FRM for registering your copy.
  565.  
  566.      You are welcome to distribute this package to others so long as it  is
  567.      unmodified and distributed in its entirety, and it is not included  or
  568.      bundled  with  other  goods  or  services  for which a fee is charged.
  569.      Exceptions are  that ZipNews  may be  distributed by  bulletin boards,
  570.      Internet archive sites, or other information services even though they
  571.      receive  fees  to  access  their  downloadable  files,  or  by library
  572.      services so long as the fee for the diskette on which this package  is
  573.      contained is not more than $6.50.
  574.  
  575.                                  ZipNews v0.97                      Page 10
  576.  
  577.      Use  of  ZipNews  beyond  a  brief  evaluation  period by individuals,
  578.      business entities, corporations, and government agencies is prohibited
  579.      without payment of a registration fee of $19.95 per copy.
  580.  
  581.      After You Register ZipNews
  582.      --------------------------
  583.  
  584.      Once your registration and check have been received, you will be  sent
  585.      a  registration  number  (via  U.S.  mail  OR Internet e-mail, at your
  586.      option).  You may use this  number to convert to a registered  copy of
  587.      ZipNews which will  eliminate displays of  "unregistered", "evaluation
  588.      copy", etc., and it will insert  your name in displays and text  files
  589.      as having duly registered the product.
  590.  
  591.      To  make  a  registered  copy,  invoke  ZipNews  with the command line
  592.      parameter of --REGISTER, thusly:
  593.  
  594.          zn --register
  595.  
  596.      You are  prompted to  enter your  name and  your registration  number.
  597.      That's all there is to it.
  598.  
  599.      (IMPORTANT NOTE:   If  you are  running a  multi-node system  and have
  600.      followed the  suggestion of  setting the  file attribute  of ZN.EXE to
  601.      READ ONLY,  you will  have to  set it  back to  normal before invoking
  602.      ZN.EXE in registration mode.  Once you have completed the registration
  603.      procedure, you should set ZN.EXE back to READ ONLY mode.)
  604.  
  605.      Support
  606.      -------
  607.  
  608.      Support is available to registered users of ZipNews primarily  through
  609.      the main message base of the Northern Lights BBS which can be  reached
  610.      at the number given below.
  611.  
  612.      Registration fees may be made payable to:
  613.  
  614.               J.C. Kilday Associates
  615.               P.O. Box 1961
  616.               Portland, ME 04104
  617.  
  618.      The author  may be  contacted at  the above  address, or  via Internet
  619.      e-mail (jkilday@nlbbs.com),   or  at the Northern Lights BBS  (address
  620.      messages to "Sysop")  at 207-761-4782.   The BBS operates  24 hours, 7
  621.      days.  Calls accepted at 14400 (v.32bis or VHST) or below.
  622.